home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat2 / standard / setwaitjobpid.z / setwaitjobpid
Encoding:
Text File  |  2001-04-17  |  3.8 KB  |  67 lines
  1.  
  2.  
  3.  
  4. sssseeeettttwwwwaaaaiiiittttjjjjoooobbbbppppiiiidddd((((2222))))                                              sssseeeettttwwwwaaaaiiiittttjjjjoooobbbbppppiiiidddd((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      setwaitjobpid - sets a job to wait for a pid to call waitjob
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////rrrreeeessssoooouuuurrrrcccceeee....hhhh>>>>
  13.  
  14.      iiiinnnntttt sssseeeettttwwwwaaaaiiiittttjjjjoooobbbbppppiiiidddd((((jjjjiiiidddd____tttt rrrrjjjjiiiidddd,,,, ppppiiiidddd____tttt wwwwppppiiiidddd))))
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      The _ssss_eeee_tttt_wwww_aaaa_iiii_tttt_jjjj_oooo_bbbb_pppp_iiii_dddd function sets a job to wait for a specified pid to call
  18.      the function _wwww_aaaa_iiii_tttt_jjjj_oooo_bbbb. If a job is set to wait for a pid, it remains
  19.      around after job termination until either the process with the pid calls
  20.      _wwww_aaaa_iiii_tttt_jjjj_oooo_bbbb or the process terminates. The _ssss_eeee_tttt_wwww_aaaa_iiii_tttt_jjjj_oooo_bbbb_pppp_iiii_dddd function takes two
  21.      arguements: the jid of the job to be set to wait and the pid of the
  22.      process that is expected to call _wwww_aaaa_iiii_tttt_jjjj_oooo_bbbb. The pid cannot be the process
  23.      calling the _ssss_eeee_tttt_wwww_aaaa_iiii_tttt_jjjj_oooo_bbbb_pppp_iiii_dddd function. If a jid of 0 is passed in, the
  24.      function will set the current job.
  25.  
  26.      The _ssss_eeee_tttt_wwww_aaaa_iiii_tttt_jjjj_oooo_bbbb_pppp_iiii_dddd function checks the specified pid's process for the
  27.      CAP_SETUID capability. If called for another job, the _ssss_eeee_tttt_wwww_aaaa_iiii_tttt_jjjj_oooo_bbbb_pppp_iiii_dddd
  28.      function checks for CAP_MAC_WRITE and CAP_PROC_MGT capability.  See the
  29.      capability(4) and capabilities(4) man pages for more information on the
  30.      capability mechanism that provides fine grained control over the
  31.      privileges of a process.
  32.  
  33.      The _ssss_eeee_tttt_wwww_aaaa_iiii_tttt_jjjj_oooo_bbbb_pppp_iiii_dddd function returns 0 if successful.
  34.  
  35. EEEERRRRRRRROOOORRRRSSSS
  36.      Under the following conditions, the function _ffff_4444_ssss_eeee_tttt_wwww_aaaa_iiii_tttt_jjjj_oooo_bbbb_pppp_iiii_dddd sets _e_r_r_n_o
  37.      to:
  38.  
  39.      [ENOPKG]       The job limits software is not installed.
  40.  
  41.      [EINVAL]       Set if pid of current process entered as an argument or
  42.                     jid specified is the pid's job.
  43.  
  44.      [ESRCH]        The pid is invalid.
  45.  
  46.      [EPERM]        If calling process or entered pid do not have capability.
  47.  
  48.      [ENOJOB]       Set if jid is invalid.
  49.  
  50. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  51.      systune(1M), waitjob(2).
  52.  
  53. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  54.      Upon successful completion, _s_e_t_w_a_i_t_j_o_b_p_i_d returns 0.  If an error occurs,
  55.      a value of -1 is returned and eeeerrrrrrrrnnnnoooo is set to indicate the error.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.